/******************************************************************************
 * @file     basic_math_functions_f16.h
 * @brief    Public header file for NMSIS DSP Library
 * @version  V1.9.0
 * @date     23 April 2021
 * Target Processor: RISC-V Cores
 ******************************************************************************/
/*
 * Copyright (c) 2010-2020 Arm Limited or its affiliates. All rights reserved.
 * Copyright (c) 2019 Nuclei Limited. All rights reserved.
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the License); you may
 * not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an AS IS BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */


#ifndef _BASIC_MATH_FUNCTIONS_F16_H_
#define _BASIC_MATH_FUNCTIONS_F16_H_

#ifdef   __cplusplus
extern "C" {
#endif

#include "riscv_math_types_f16.h"
#include "riscv_math_memory.h"

#include "dsp/none.h"
#include "dsp/utils.h"


#if defined(RISCV_FLOAT16_SUPPORTED)


/**
 * @brief Floating-point vector addition.
 * @param[in]  pSrcA      points to the first input vector
 * @param[in]  pSrcB      points to the second input vector
 * @param[out] pDst       points to the output vector
 * @param[in]  blockSize  number of samples in each vector
 */
void riscv_add_f16(
    const float16_t* pSrcA,
    const float16_t* pSrcB,
    float16_t* pDst,
    uint32_t blockSize);

/**
 * @brief Floating-point vector subtraction.
 * @param[in]  pSrcA      points to the first input vector
 * @param[in]  pSrcB      points to the second input vector
 * @param[out] pDst       points to the output vector
 * @param[in]  blockSize  number of samples in each vector
 */
void riscv_sub_f16(
    const float16_t* pSrcA,
    const float16_t* pSrcB,
    float16_t* pDst,
    uint32_t blockSize);

/**
* @brief Multiplies a floating-point vector by a scalar.
* @param[in]  pSrc       points to the input vector
* @param[in]  scale      scale factor to be applied
* @param[out] pDst       points to the output vector
* @param[in]  blockSize  number of samples in the vector
*/
void riscv_scale_f16(
    const float16_t* pSrc,
    float16_t scale,
    float16_t* pDst,
    uint32_t blockSize);

/**
* @brief Floating-point vector absolute value.
* @param[in]  pSrc       points to the input buffer
* @param[out] pDst       points to the output buffer
* @param[in]  blockSize  number of samples in each vector
*/
void riscv_abs_f16(
    const float16_t* pSrc,
    float16_t* pDst,
    uint32_t blockSize);


/**
 * @brief  Adds a constant offset to a floating-point vector.
 * @param[in]  pSrc       points to the input vector
 * @param[in]  offset     is the offset to be added
 * @param[out] pDst       points to the output vector
 * @param[in]  blockSize  number of samples in the vector
 */
void riscv_offset_f16(
    const float16_t* pSrc,
    float16_t offset,
    float16_t* pDst,
    uint32_t blockSize);

/**
 * @brief Dot product of floating-point vectors.
 * @param[in]  pSrcA      points to the first input vector
 * @param[in]  pSrcB      points to the second input vector
 * @param[in]  blockSize  number of samples in each vector
 * @param[out] result     output result returned here
 */
void riscv_dot_prod_f16(
    const float16_t* pSrcA,
    const float16_t* pSrcB,
    uint32_t blockSize,
    float16_t* result);

/**
 * @brief Floating-point vector multiplication.
 * @param[in]  pSrcA      points to the first input vector
 * @param[in]  pSrcB      points to the second input vector
 * @param[out] pDst       points to the output vector
 * @param[in]  blockSize  number of samples in each vector
 */
void riscv_mult_f16(
    const float16_t* pSrcA,
    const float16_t* pSrcB,
    float16_t* pDst,
    uint32_t blockSize);

/**
 * @brief  Negates the elements of a floating-point vector.
 * @param[in]  pSrc       points to the input vector
 * @param[out] pDst       points to the output vector
 * @param[in]  blockSize  number of samples in the vector
 */
void riscv_negate_f16(
    const float16_t* pSrc,
    float16_t* pDst,
    uint32_t blockSize);

/**
@brief         Elementwise floating-point clipping
@param[in]     pSrc          points to input values
@param[out]    pDst          points to output clipped values
@param[in]     low           lower bound
@param[in]     high          higher bound
@param[in]     numSamples    number of samples to clip
@return        none
*/

void riscv_clip_f16(const float16_t* pSrc,
                    float16_t* pDst,
                    float16_t low,
                    float16_t high,
                    uint32_t numSamples);

#endif /* defined(RISCV_FLOAT16_SUPPORTED)*/

#ifdef   __cplusplus
}
#endif

#endif /* ifndef _BASIC_MATH_FUNCTIONS_F16_H_ */
